跳到主要内容

OpenClaw 温湿度仪表盘教程

开始前请先完成 使用前准备 目录下的 [01-外设硬件配置]、[02-openclaw Ajetson-KEY配置]、[03-openclaw切换模型]、[04-AI语音交互配置]、[05-三种对话方案配置测试]。如果当前只使用 TUI / 飞书，可以先跳过 04。本文默认基础环境已经准备完成，只展开温湿度仪表盘项目本身。

1. 教程目标​

本文通过“传感器 + 显示 + 指示”的组合，展示 OpenClaw 在桌面仪表盘场景中的多外设协同能力。完成本教程后，读者可以：

  • 了解如何把 DHT、OLED、RGB 和舵机组合成一个温湿度仪表盘

  • 通过飞书、TUI、语音代码三种方式和 OpenClaw 对话

  • 完成四个项目场景：实时读数、OLED 指标盘、RGB 状态灯、舵机指针映射

2. 硬件准备​

  • OpenClaw 主控板

  • DHT 温湿度传感器

  • OLED 显示屏

  • RGB 灯带 / RGB 灯珠模块

  • [可选] AI语音模块+扬声器

  • 接线图

image-20260601095549027

3. 软件准备​

教程中会用到的代码入口

  • 温湿度读取命令：/home/jetson/hardware_hal_demo/dht

  • OLED 控制命令：/home/jetson/hardware_hal_demo/oled

  • RGB 控制命令：/home/jetson/hardware_hal_demo/rgb

  • 舵机控制命令：/home/jetson/hardware_hal_demo/cli/servo

  • 语音入口：/home/jetson/voice_to_openclaw/src/main.py

这个项目和 AI 气象站很接近，但侧重点不同：

  • AI 气象站更强调“播报”和“解释”

  • 温湿度仪表盘更强调“显示”和“状态映射”

4. 测试项目基础能力​

开始当前项目之前，请先完成一次 openclaw tui 基础对话自检；如果还没做，先看 [05-三种对话方案配置测试]。通过后，再进入温湿度仪表盘专项测试。

建议先进入 OpenClaw TUI：

openclaw tui

image-20260529194358126

然后依次测试下面几类指令：

  • 读取当前温湿度

  • 在 OLED 上显示当前温湿度

  • 如果环境正常就亮绿灯

  • 把舵机转到 90 度

5. 和 OpenClaw 对话的三种方案​

方案适合场景优点建议定位
飞书远程查看状态、课堂演示方便远程读取当前面板数据展示“远程监测面板”
TUI本地调试、映射验证最容易排查读数和动作关系先跑通可视化链路
语音代码语音播报、桌面助手更贴近日常使用方式作为完整演示方案

如果选配了AI语音模块+扬声器，飞书对话、tui、whatsapp对话需要播报openclaw回复的内容，可以终端运行下面的程序，ai语音模块对话不需要重复运行

  • 修改是否打开播报参数

xxxxxxxxxx /home/jetson/voice_to_openclaw/.env xxxxxxxxxx ENABLE_TTS = true #这个参数就是控制是否播报，修改完保存，终端运行下面程序

  • 终端输入

xxxxxxxxxx cd ~/ voice_to_openclaw source . venv / bin / activate python \- m src . openclaw_session_tts

image-20260529194326500

5.1 飞书方案​

飞书接入和机器人创建步骤请直接参考 [05-三种对话方案配置测试]。创建好之后，就可以在飞书里远程查看仪表盘状态，例如：

  • 温湿度仪表盘

image-20260428184244000

5.2 TUI 方案​

如果已经完成第 0 篇中的 TUI 自检，直接进入终端文字对话：

xxxxxxxxxx openclaw tui

然后输入项目相关指令，例如：

  • 温湿度仪表盘

image-20260428184318072

5.3 语音代码方案​

xxxxxxxxxx 需要选配 ai 语音交互模块 + 扬声器

语音模块安装、环境配置和基础唤醒流程请直接参考 [04-AI语音交互配置]。唤醒之后，就可以直接说出控制内容，例如：

  • 温湿度仪表盘

image-20260529194336084

6. 项目实现​

注意：下面都是在 openclaw tui 方式进行对话演示，你也可以自己选择飞书或语音方式来完成。

6.1 场景一：实时读数​

实验目标​

读取当前温湿度，完成仪表盘的基础数据输入。

效果说明​

OpenClaw 会先拿到温度和湿度读数，这些值就是后续 OLED、RGB 和舵机映射的基础。

示例指令​

  • 读取当前温湿度

  • 现在温度和湿度是多少

  • 帮我刷新一下当前读数

6.2 场景二：OLED 指标盘​

实验目标​

把当前温湿度结果显示成简洁的 OLED 仪表盘内容。

效果说明​

这里适合使用 metrics 或 dht_oled 方式，把 Temp 和 Hum 组合成一块紧凑的屏幕区域，形成一个小型数据面板。

示例指令​

  • 在 OLED 上显示 Temp 和 Hum

  • 做一个简单温湿度面板

  • 把当前温湿度写到屏幕上

6.3 场景三：RGB 状态灯​

实验目标​

用 RGB 颜色表达当前环境属于正常、偏热、偏冷或偏干等状态。

效果说明​

这个环节可以让仪表盘更直观。比如正常亮绿色，偏热亮黄色，异常亮红色，偏冷亮蓝色，一眼就能看出状态。

示例指令​

  • 如果环境正常就亮绿灯

  • 如果温度高就亮黄灯

  • 如果湿度异常就亮红灯

6.4 场景四：舵机指针映射​

实验目标​

把温度或湿度映射到舵机角度，让舵机像仪表盘指针一样指向一个位置。

效果说明​

例如把温度区间映射到 0 到 180 度，当前温度越高，舵机指针越往右。这个效果很适合做课堂展示，因为“数字变成物理动作”会非常直观。

示例指令​

  • 用舵机像指针一样表示当前温度

  • 把当前温度映射到舵机角度

  • 让指针指向当前状态